package org.eiahe.hr.salary.service;

import org.ehe.common.mybatis.core.page.PageQuery;
import org.ehe.common.mybatis.core.page.TableDataInfo;
import org.eiahe.hr.salary.domain.bo.SalaryStructureBo;
import org.eiahe.hr.salary.domain.vo.SalaryStructureVo;
import org.eiahe.hr.salary.domain.vo.EmployeeSalaryVo;

import java.math.BigDecimal;
import java.util.Collection;
import java.util.List;

/**
 * 薪资构成Service接口
 *
 * @author zhangnn
 */
public interface ISalaryStructureService {

    /**
     * 查询薪资构成
     *
     * @param structureId 薪资构成ID
     * @return 薪资构成
     */
    SalaryStructureVo queryById(Long structureId);

    /**
     * 查询薪资构成列表
     *
     * @param bo 薪资构成业务对象
     * @return 薪资构成集合
     */
    List<SalaryStructureVo> queryList(SalaryStructureBo bo);

    /**
     * 分页查询薪资构成列表
     *
     * @param bo        薪资构成业务对象
     * @param pageQuery 分页参数
     * @return 薪资构成分页数据
     */
    TableDataInfo<SalaryStructureVo> queryPageList(SalaryStructureBo bo, PageQuery pageQuery);

    /**
     * 新增薪资构成
     *
     * @param bo 薪资构成业务对象
     * @return 是否成功
     */
    Boolean insertByBo(SalaryStructureBo bo);

    /**
     * 修改薪资构成
     *
     * @param bo 薪资构成业务对象
     * @return 是否成功
     */
    Boolean updateByBo(SalaryStructureBo bo);

    /**
     * 批量删除薪资构成
     *
     * @param ids 薪资构成ID数组
     * @return 是否成功
     */
    Boolean deleteWithValidByIds(Collection<Long> ids);

    /**
     * 员工查询自己的薪资列表（敏感信息已模糊处理）
     *
     * @param employeeNo 工号
     * @param yearMonth  年月(yyyyMM格式)
     * @return 员工薪资列表
     */
    List<EmployeeSalaryVo> queryEmployeeSalaryList(String employeeNo, String yearMonth);

    /**
     * 员工分页查询自己的薪资列表（敏感信息已模糊处理）
     *
     * @param employeeNo 工号
     * @param yearMonth  年月(yyyyMM格式)
     * @param pageQuery  分页参数
     * @return 员工薪资分页数据
     */
    TableDataInfo<EmployeeSalaryVo> queryEmployeeSalaryPageList(String employeeNo, String yearMonth,
            PageQuery pageQuery);

    /**
     * 根据ID获取员工薪资详情（可选择是否脱敏）
     *
     * @param structureId 薪资构成ID
     * @param maskData    是否脱敏数据
     * @return 员工薪资详情
     */
    EmployeeSalaryVo getEmployeeSalaryDetail(Long structureId, boolean maskData);

    /**
     * 模糊处理薪资金额
     *
     * @param amount 金额
     * @return 模糊处理后的金额字符串（如 *****）
     */
    String maskSalaryAmount(BigDecimal amount);
}